home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / HSI2ARR.ZIP / README.TXT < prev   
Text File  |  1994-08-17  |  3KB  |  54 lines
  1. HSI2ARR.EXE -- Converts HSI RAW Pictures to C arrays (C Source included)
  2. By Darion (thimj@u.washington.edu)
  3.  
  4.     This utility converts the HSI RAW format, put out by Handmade Software
  5. to C readable arrays.  The command line for the executable is as follows.
  6.  
  7.     hsi2arr.exe <input_file> <output_file>
  8.  
  9.     Where input file is the RAW image you want converted, and the output file
  10. is the header file you want created for your programming.  The input file must
  11. be prepared with IMAGE ALCHEMY 1.7.  Available from oak.oakland.edu under
  12. /pub/msdos/graphics/alch17.zip (or somewhere close like that).  That is only a
  13. demo version of Image Alchemy.  The command line switch for converting a graphic
  14. image to a raw file is
  15.  
  16.     alchemy -r <input_file> <output_file>
  17.  
  18. Example:  This will convert a 16 color PCX file to a 256 Color RAW file.
  19.     alchemy -r -c256 <peace.pcx> <peace.raw>
  20.  
  21.     The output file will include several defines, including the WIDTH, HEIGHT,
  22. GAMMA, HORDPI, VERDPI, and COLOR #defines.  It will then have a character array
  23. for holding the palette data.  This can range from 6 - 768 bytes, depending on
  24. how many colors the converted file had.  It then defines the actual picture data
  25. in a double-dimensioned array, ie:  PICDATA[200][320].
  26.  
  27. This packages comes with two examples of using the header files.  Both are very
  28. simple examples.
  29.  
  30.     histest.c is a 96x96 256c RAW file that is displayed.  Compiled with TC 3.0,
  31.     small memory model.
  32.  
  33.     histest3.c is a 320x200 256C RAW file that is displayed.  Compiled with TC
  34.     3.0 and a compact memory model.
  35.  
  36.     HSI2ARR assumes you will be using the _SMALL_ memory model so be sure to
  37. change the output file to match which model you are using.  ie:  If your
  38. picture data is 64000+ bytes or larger, you need to change it from:
  39.  
  40.     char PICDATA[200][320] to char far PICDATA[200][320]
  41.  
  42.     If you use this program and find it to be helpful, greet me or something!
  43.     I am releasing this as EMAILware.  If you use it steadily you *MUST* email
  44. me and flame me about my bad coding style, comment me on the program, suggest
  45. additions to the program, etc, etc.  You can modify this code AS MUCH AS YOU
  46. want to, AS LONG as you credit me in the modified sources and/or executable.
  47.  
  48. TRADEMARKS:  Image Alchemy and HSI RAW are trademarks of Handmade Software Inc.
  49.  
  50. I supply each of the programs on an 'as is' basis in the hope that
  51. they will be useful but with absolutely no warranty of any kind, and assume
  52. no liability or responsibility for any ill they may cause whatsoever.
  53.  
  54.